home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
FishMarket 1.0
/
FishMarket v1.0.iso
/
fishies
/
551-575
/
disk_570
/
fass
/
fass.doc
< prev
next >
Wrap
Text File
|
1992-05-06
|
7KB
|
179 lines
Fass v1.02
© Copyright 1991 Jaba Development
Written with DICE C v2.6 by
Jan van den Baard
Based on commodity code by Stefan Sticht (FISH 497)
DISCAIMER
---------------------------------------------------------------------------
The author is NOT responsible for the suitability or accuracy of this
documentation and/or the program(s) it describes. Any damage directly or
indirectly caused by the use or misuse of this documentation and/or the
program(s) it describes is the sole responsibility of the user her/him self
---------------------------------------------------------------------------
COPYRIGHT
---------------------------------------------------------------------------
Fass v1.01, © Copyright 1991 Jaba Development. All rights reserved.
This program may be distributed non-commercially only providing that the
executable, source code, documentation and copyright notices remain
unchanged and are included with the distribution. This program is FREEWARE
so no financial donation is necessary ( but welcome ). Send me a postcard
of your hometown if you use this program.
---------------------------------------------------------------------------
This program is for all of you who has programs that makes use of fonts
but don't offer the possibility to change the fonts directory from within
the program. Fass is a commodity that offers the possibility to re-assign
the fonts directory a the touch of a few keys. It's possible to start Fass
from either the Shell or the Workbench. The following arguments are
possible:
PRIORITY=<pri> - With this argument it's possible to set the
commodity it's priority in the commodities queue.
Default : 0
POPWINDOW=<YES|NO> - This enables you to tell wether or not you want
Fass to open it's window uppon startup.
Default : NO
POPKEY=<hotkey> - This enables you to set your own hotkey (See below)
to popup Fass it's window
Default : lalt f
QUIT=<hotkey> - This enables you to set your own hotkey (See below)
to quit the commodity.
Default : lalt q
Here are some examples of how you can start Fass from the Shell:
Run Fass POPWINDOW=YES POPKEY="lcommand p"
Run Fass QUIT "control q"
NOTE: You have to "Run" or "RunBack" Fass when you start it from the
Shell. This is because DICE does not have an auto detach "_main.c".
(Maybee I'll hack my own some day.....)
You must specify the arguments via the tooltypes array of the program it's
icon when it's started from the Workbench. When you start Fass from
the WBStartup drawer you must specify the DONOTWAIT tooltype.
The Fass window:
The Fass window always opens on the default public screen. When the window
is open you will see five gadgets:
Get -> This pops the ASL FileRequester for you to
select a new fonts directory.
Please enter FONTS: path -> Type the pathname of the new fonts directory
in here. NOTE: Fass only checks wether or not
it's a directory you have entered here. There
is no checking to see if there are really
fonts in the directory.
Assign -> Click on this gadget when you want to assign
the FONTS: directory to you new path. A
requester pops up telling you wether or not
it succeeded.
HIDE -> Click on this gadget to hide the Fass window.
QUIT -> Click on this gadget to remove Fass from the
system.
Input Description Strings (HotKeys):
The Input Description String (HotKeys) has the following template:
<qualifier> [qualifier] [...] <key>
qualifier: lshift left shift key
rshift right shift key
shift either shift key
capslock capslock key
caps shift or capslock key
control control key
lalt left alt key
ralt right alt key
alt either alt key
lcommand left amiga key
rcommand right amiga key
numericpad key on numericpad
rbutton right mouse button
midbutton middle mouse button
leftbutton left mouse button
newprefs change in preferences
diskremoved disk ejected
diskinserted guess what.....
key f1 -> f10 function keys
up cursor up key
down cursor down key
left cursor left key
right cursor right key
help help key
del delete key
return return key
enter enter key
backspace backspace key
esc escape key
space space key
comma comma key
upstroke key released
a -> z, 0 -> 9 normal ansi keys
Choose your keys carefully when other commodities are running.
Requirements:
Fass needs atleast Kickstart 2.0 V36++ to run.
Error return codes.
Fass doesn't print information to the screen when something didn't work. You
can figure out what went wrong by checking the return code with this list.
20 FASS wasn't able to open the libraries it so desperatly needs.
21 FASS wasn't able to create a message port for the communication.
22 The broker could not be setup. This could mean that another commodity
is running which has the same name as FASS.
23 FASS wasn't able to setup it's HotKey filters. This probably means
that you have fed FASS wierd HotKey strings.
24 There was an error detected if the commodity objects with CxObjError.
25 Not used!
26 Not used.
27 You passed FASS wierd arguments in the Shell.
History:
V1.00 (15-Sep-1991) 7436 bytes.
- Initial release
V1.01 (21-Sep-1991) 6872 bytes.
- Fass now uses the Dos routine "ReadArgs()" for parsing the arguments
when run from the Shell.
- By-Passed the main from c.lib to trim some bytes off the executable.
V1.02 (17-Oct-1991) 7312 bytes.
- Fass now enables the user to select the new fonts directory with the
ASL FileRequester.
Bug reports, flames, etc. to me at the following address.
Jan van den Baard
Bakkerstraat 176
3082 HE, Rotterdam
Holland
Fido: 2:500/29 (Jan van.den.Baard)